home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / prog / xlib30.arj / README.DOC < prev    next >
Text File  |  1993-12-21  |  9KB  |  184 lines
  1. ******************************************************************************
  2. Registering XLIB
  3. ******************************************************************************
  4.      XLIB may be registered for $40.  Registrants will be sent a registered
  5. copy of the XLIB archive along with a printed copy of the user manual.  
  6. There are three ways to register XLIB:
  7.  
  8. 1) By credit card through Public (software) Library:
  9.  
  10.      You can order with MC, Visa, Amex, or Discover from Public (software)
  11. Library by calling 800-2424-PsL or 713-524-6394 or by FAX to 713-524-6398
  12. or by CIS Email to 71355,470.  You can also mail credit card orders to PsL
  13. at P.O.Box 35705, Houston, TX 77235-5705.
  14.  
  15. THE ABOVE NUMBERS ARE FOR ORDERS ONLY.  Any questions about the status of 
  16. the shipment of the order, refunds, registration options, product details, 
  17. technical support, volume discounts, dealer pricing, site licenses, etc, 
  18. should NOT be directed to PsL.  Direct all such questions to TechniLib.
  19.  
  20. 2) Through CompuServe:
  21.      
  22.      Use GO SWREG (shareware registration).  The program identification number 
  23. is 1423.  The program title is XLIB 3.0.  
  24.  
  25. 3) By mail to TechniLib:
  26.  
  27.      Complete and mail the form in REGISTER.FRM
  28.  
  29. ******************************************************************************
  30. Communicating with TechniLib Via Electronic Mail
  31. ******************************************************************************
  32.  
  33.      You can communicate with TechniLib via CompuServe electronic mail.  Direct
  34. mail to account 74730,167.  
  35.  
  36. ******************************************************************************
  37. Quick Start with XLIB
  38. ******************************************************************************
  39.  
  40.      The user manual is largely dedicated to cover specifics of XLIB which will
  41. not be of concern to many programmers.  A few notes are added here to expedite 
  42. matters for these programmers.
  43.      If all you need is the ability to access extended memory from within a 
  44. real-mode high-level langauge, then consider using EASYX rather than XLIB.
  45. EASYX does not require usage or knowlege of assembly language.  The 
  46. documentation for EASYX is in the file EASYX.DOC.
  47.      Most programmers will find nearly all that they need to know about XLIB 
  48. from the introductory chapter in the XLIB documentation.  One should also
  49. study the predefined selectors and descriptors in Chapter 2, and the GETMEM
  50. and PMGETMEM functions in Chapter 7.
  51.      C programmers wishing to use inline protected-mode execution should study
  52. the inline mode switch procedures in Chapter 5.
  53.  
  54. ******************************************************************************
  55. Instructions for Constructing Protected-Mode Libraries for Microsoft
  56. ******************************************************************************
  57.  
  58.      The following batch file uses Microsoft LIB to combine an OBJ file with
  59. XLIB.LIB to produce a protected-mode library.  Call the batch file using the
  60. base name of the OBJ file as the argument.  This base name will also be given
  61. to the library.  It is assumed that all files, including LIB.EXE, are in the
  62. current directory.
  63.  
  64. @echo on
  65. del %1.lib
  66. lib %1.lib /noi +%1.obj+xlib.lib;
  67.  
  68.      The following batch file uses Microsoft LINK and LIB to combine an OBJ
  69. file with XLIB.LIB to produce a protected-mode library and quick library for
  70. Microsoft BASIC 7.0.  Call the batch file using the base name of the OBJ
  71. file as the argument.  This base name will also be given to the library and 
  72. the quick library.  It is assumed that all files, including LINK.EXE and 
  73. LIB.EXE, are in the current directory.  The current directory must also 
  74. contain the file QBXQLB.LIB (included in the BASIC distribution disks).
  75.  
  76. @echo on
  77. del %1.qlb
  78. del %1.lib
  79. link /q/nopackf xlib.lib+%1.obj,%1.qlb,,qbxqlb.lib;
  80. lib %1.lib +xlib.lib+%1.obj; 
  81.  
  82. ******************************************************************************
  83. Instructions for Constructing Libraries and Linking with Borland
  84. ******************************************************************************
  85.  
  86.      The following batch file uses Borland TLIB to combine an OBJ file with
  87. XLIBB.LIB to produce a protected-mode library.  Call the batch file using the
  88. base name of the OBJ file as the argument.  This base name will also be given
  89. to the library.  It is assumed that all files, including TLIB.EXE, are in the
  90. current directory.
  91.  
  92. @echo on
  93. del %1.lib
  94. tlib /C %1.lib +xlibb.lib+%1.obj
  95.  
  96.      Borland C and Turbo C users can compile within the IDE; however, they must
  97. use the command-line linker because an option will be needed which is not
  98. included in the IDE linker.  In particular, the /3 option will be needed to
  99. enable processing of 32-bit segments.  The appropriate commands to TLINK will
  100. depend upon the memory model being used.  The following batch command will 
  101. link a program called MYPROG with a library call MYLIB under the large memory 
  102. model.  The batch command must be issued from the directory containing 
  103. MYPROG.OBJ.  It is assumed that TLINK is in the ..\BIN directory and that
  104. MYLIB.LIB is in the ..\LIB directory.  It is also assumed that all of the C 
  105. link libraries are in the ..\LIB directory.  The resulting executable will be 
  106. called MYPROG.EXE and the map file will be called MYPROG.MAP.  The command 
  107. line is lengthy and is therefore broken into two lines below.
  108.  
  109.  
  110.                                                      --------------------- model specification
  111.                                                      .   ----------------- obj file name
  112.                                                      .   |      ---------- exe file name
  113.                                                      .   |      |      --- map file name
  114.                                                      . ______ ______ ______
  115. ..\BIN\TLINK /3/c ..\LIB\C0L MYPROG,MYPROG,MYPROG,
  116.  
  117.      ..\LIB\MYLIB ..\LIB\FP87 ..\LIB\MATHL ..\LIB\CL 
  118.                     -----                        .         .
  119.                         |                          -------------- model specification
  120.                         ----------------------------------------- lib file name
  121.  
  122. To link under the small memory model, replace "L" with "S" at the model
  123. specification characters.  Use "M" for the medium model; "C" for the compact
  124. model, and "H" for the huge model.
  125.  
  126. ******************************************************************************
  127. Instructions for Debugging in the Borland IDE
  128. ******************************************************************************
  129.  
  130.      To run the IDE debugger, XLIB should be initialized for VCPI.  However,
  131. under the default behavior of the IDE, a VCPI program will not be able to
  132. allocate extended memory within the IDE.  There are potentially two reasons 
  133. for this.  First, the default behavior of the DPMI kernel under which the 
  134. IDE operates is to claim all EMS memory and convert it to DPMI memory.  
  135. Since VCPI seeks extended memory through EMS, no extended memory will appear 
  136. to be available.  To limit the memory consumption of the DPMI kernel, 
  137. include a statement such as the following in the batch file used to invoke 
  138. the IDE:
  139.  
  140. set dpmimem=maxmam 2000
  141.  
  142. This statement limits the memory usage of the DPMI kernel to 2000Kb.  If
  143. EMS memory exceeds this amount, then EMS memory will be available to the 
  144. IDE.  However, EMS memory will not be available to a VCPI program running 
  145. within the IDE if the IDE has itself consumed all EMS memory.  Therefore, 
  146. one may have to limit EMS memory usage of the IDE.  This can be done in the 
  147. OPTIONS|ENVIRONMENT|STARTUP menu of the IDE.  Typically, EMS memory usage
  148. should be set to zero here.
  149.  
  150. ******************************************************************************
  151. Improvements in XLIB Version 2.0 Over Version 1.0
  152. ******************************************************************************
  153.  
  154. 1) Procedures enabling protected-mode programming in C using inline assembly.
  155. 2) Protected-mode file routines which can transfer extended memory to files 
  156.      or files to extended memory.  Sequential and random access are supported.
  157. 3) Better interrupt management services.
  158. 4) User-defined descriptors.
  159. 5) More descriptors.  
  160. 6) More configurability.
  161. 7) Minor bug fixes
  162. 8) Better documentation.
  163.  
  164. ******************************************************************************
  165. Improvements in XLIB Version 3.0 Over Version 2.0
  166. ******************************************************************************
  167.  
  168. 1) Files included in Borland formats.
  169. 2) EASYX library included for those unfamiliar with assembly langauge.
  170. 3) MAPIO and PMMAPIO procedures added to XLIB for accessing memory-mapped 
  171.      input/output devices.
  172. 4) Better documentation
  173.  
  174. ******************************************************************************
  175. Explanation of PMPRINT.ASM
  176. ******************************************************************************
  177.  
  178.      Since protected-mode debuggers are hard to find, a programmer is greatly
  179. assisted by a set of screen management routines when preparing such code.  The
  180. file PMPRINT.INC includes a set of basic screen routines for protected-mode.
  181. Programmers using monochrome monitors will have to change the base address for
  182. the screen.  This file is included for your convenience.
  183.  
  184.